home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / cosmocreate.z / cosmocreate
Text File  |  1998-10-30  |  20KB  |  331 lines
  1.  
  2.  
  3.  
  4. CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))                   CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee                    CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cosmocreate - WYSIWYG HTML authoring tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccoooossssmmmmooooccccrrrreeeeaaaatttteeee [ X toolkitoption... ] [----ddddeeeeffffaaaauuuullllttttvvvviiiissssuuuuaaaallll]
  13.                  [----eeeemmmmaaaaccccssss] [----hhhheeeellllpppp] [----rrrruuuunnnnmmmmaaaannnnyyyy] [----wwwwaaaarrrrnnnn]
  14.                  [----ssssoooouuuurrrrcccceeeelllliiiinnnneeee ##] [HTML files...]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _c_o_s_m_o_c_r_e_a_t_e is a WYSIWYG editor for creating HyperText Markup Language
  18.      (HTML) documents for publishing on the World Wide Web (WWW). Through its
  19.      WYSIWYG interface and its tight integration with the IRIX Interactive
  20.      Desktop, _c_o_s_m_o_c_r_e_a_t_e greatly simplifies the task of creating compelling
  21.      HTML documents.
  22.  
  23.      The _c_o_s_m_o_c_r_e_a_t_e program contains extensive online help and users guide.
  24.      For this reason, this man page will not go into detail on the interactive
  25.      aspects of the program. Please read the Cosmo Create
  26.       online User's Guide available from the _c_o_s_m_o_c_r_e_a_t_e help menu.
  27.  
  28.      This manual page supplements the online help by providing information on
  29.      the configuration and administration of _c_o_s_m_o_c_r_e_a_t_e.
  30.  
  31.    EEEEddddiiiittttoooorrrr KKKKeeeeyyyy BBBBiiiinnnnddddiiiinnnnggggssss
  32.      The default _c_o_s_m_o_c_r_e_a_t_e key bindings are those used by the Motif XmText
  33.      widget. In addition, the menu accelerators obey the _I_R_I_X _I_n_t_e_r_a_c_t_i_v_e _U_s_e_r
  34.      _I_n_t_e_r_f_a_c_e _G_u_i_d_e_l_i_n_e_s and use the Ctrl key. Specifying the ----eeeemmmmaaaaccccssss
  35.      command-line option runs _c_o_s_m_o_c_r_e_a_t_e using a subset of the Emacs editor
  36.      key bindings. In Emacs mode, the menu accelerators use the Alt key
  37.      instead of the Ctrl key.
  38.  
  39.    RRRReeeeuuuussssiiiinnnngggg tttthhhheeee EEEEddddiiiittttoooorrrr
  40.      Normally a single copy of the _c_o_s_m_o_c_r_e_a_t_e program runs and multiple
  41.      editing windows are opened from that single copy. If a copy of
  42.      _c_o_s_m_o_c_r_e_a_t_e is already running, attempting to execute a another copy of
  43.      the program will simply open a new editing window on the original copy of
  44.      the program. If a file was specified when attempting to run the
  45.      additional copy of the program, that file will be opened for editing in
  46.      the new editing window on the original copy of the program.  This
  47.      behavior is called _r_u_n _o_n_c_e. Though it is discouraged, multiple copies of
  48.      _c_o_s_m_o_c_r_e_a_t_e can be run by specifying ----rrrruuuunnnnmmmmaaaannnnyyyy on the command-line of each
  49.      additional copy of the program. Note that each copy of the program will
  50.      display its own set of tool palettes.
  51.  
  52.    CCCCoooolllloooorrrrmmmmaaaappppssss aaaannnndddd VVVViiiissssuuuuaaaallllssss
  53.      By default, _c_o_s_m_o_c_r_e_a_t_e tries to run in 24-bit mode. This mode provides
  54.      the best color reproduction for images and allocates a very small number
  55.      of colors from the default system colormap. If 24-bit mode is not
  56.      available on the system or the ----ddddeeeeffffaaaauuuullllttttvvvviiiissssuuuuaaaallll command-line option is
  57.      specified, the default visual mode (typically 8-bit) will be used. The
  58.      use of this mode produces dithered images and may allocate a large number
  59.      of colors from the default system colormap.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))                   CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee                    CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))
  71.  
  72.  
  73.  
  74.    FFFFiiiilllleeee BBBBaaaacccckkkkuuuupppp aaaannnndddd CCCChhhheeeecccckkkkppppooooiiiinnnnttttiiiinnnngggg
  75.      By default, _c_o_s_m_o_c_r_e_a_t_e creates a backup file of your original document
  76.      when you first save any changes to the document. This backup file has the
  77.      same name as the original file with ._b_a_k appended and is created in the
  78.      same directory as the original file.
  79.  
  80.      In addition to backup files, _c_o_s_m_o_c_r_e_a_t_e creates a checkpoint file every
  81.      2 minutes by default. If the editor should exit unexpectedly before the
  82.      current document has been saved, the checkpoint file provides a recent
  83.      copy of the edited file and image maps, if any. The checkpoint interval
  84.      can be changed using the program preferences dialog. Checkpoint files
  85.      have a ._s_a_v suffix. If a new document has never been saved, the
  86.      checkpoint file is called _C_o_s_m_o_C_r_e_a_t_e-uuuusssseeeerrrrnnnnaaaammmmeeee-iiiidddd._s_a_v. If the document
  87.      has been saved, the checkpoint file is called ffffiiiilllleeeennnnaaaammmmeeee-uuuusssseeeerrrrnnnnaaaammmmeeee-iiiidddd._s_a_v.
  88.      Checkpoint files are normally created in the same directory as the
  89.      current file. If a checkpoint file cannot be saved in the current
  90.      directory, an attempt is made to save it in /_v_a_r/_t_m_p.  Checkpoint files
  91.      are automatically deleted when _c_o_s_m_o_c_r_e_a_t_e terminates normally.
  92.  
  93.    FFFFoooonnnnttttssss
  94.      In keeping with the spirit of a markup language, _c_o_s_m_o_c_r_e_a_t_e users do not
  95.      specify font names and sizes directly. Font name and size are determined
  96.      by the paragraph style and font style selected for a portion of text.
  97.      Paragraph and font styles are mapped to actual font names and sizes in
  98.      the application resource file /_u_s_r/_l_i_b/_X_1_1/_a_p_p-_d_e_f_a_u_l_t_s/_C_o_s_m_o_C_r_e_a_t_e.  The
  99.      font names and sizes have been chosen to closely match those used by
  100.      common Web browsers such as Netscape. Users may choose among three font
  101.      set sizes: small, medium (default), and large. To select a font set size,
  102.      set the _C_o_s_m_o_C_r_e_a_t_e*_f_o_n_t_S_i_z_e_P_r_e_f_e_r_e_n_c_e resource to one of ssssmmmmaaaallllllll, mmmmeeeeddddiiiiuuuummmm,
  103.      or llllaaaarrrrggggeeee. You can specify individual font names and sizes within each
  104.      font set. However, doing this may compromise the WYSIWYG nature of
  105.      _c_o_s_m_o_c_r_e_a_t_e.
  106.  
  107.      The Courier font is substituted for any font that is not available on the
  108.      system.
  109.  
  110.    CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn FFFFiiiilllleeeessss
  111.      _c_o_s_m_o_c_r_e_a_t_e places configuration files in a directory called
  112.      ._c_o_s_m_o_c_r_e_a_t_e.  One of these configuration files, _c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s
  113.      contains user preference settings. The file is an ASCII text file and
  114.      contains comments describing its contents.
  115.  
  116.      On startup, _c_o_s_m_o_c_r_e_a_t_e first checks the environment for the
  117.      CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE____CCCCOOOONNNNFFFFIIIIGGGGDDDDIIIIRRRR variable. If this variable is set, its value is the
  118.      full pathname of the configuration file directory. If the environment
  119.      variable is not set, _c_o_s_m_o_c_r_e_a_t_e next looks for a configuration file
  120.      directory called ._c_o_s_m_o_c_r_e_a_t_e in the current working directory. If the
  121.      directory is not found, the program looks for it in the user's home
  122.      directory.  By placing a copy of the ._c_o_s_m_o_c_r_e_a_t_e directory in your
  123.      project root directory, you can customize the program preferences for
  124.      that project.
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))                   CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee                    CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))
  137.  
  138.  
  139.  
  140.      If _c_o_s_m_o_c_r_e_a_t_e does not find a ._c_o_s_m_o_c_r_e_a_t_e directory but does find a
  141.      ._w_e_b_m_a_g_i_c-_p_r_e_f_e_r_e_n_c_e_s file in a given directory, that file will be used
  142.      and renamed to ._c_o_s_m_o_c_r_e_a_t_e/_c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s.
  143.  
  144.    AAAAddddddddiiiinnnngggg WWWWeeeebbbb BBBBrrrroooowwwwsssseeeerrrrssss
  145.      The list of Web browsers available for previewing the current page is
  146.      user extensible. To edit the list of Web browsers select the BBBBrrrroooowwwwsssseeeerrrrssss
  147.      category on the Preferences dialog.
  148.  
  149.      The _N_a_m_e is the common name of the browser (e.g. Netscape). The name
  150.      should not contain any whitespace. The _P_a_t_h_n_a_m_e is the absolute or
  151.      relative pathname of the browser. If a pathname is provided without a
  152.      leading path, the PPPPAAAATTTTHHHH will be searched to find the file. The browser can
  153.      be set to be the preferred browser using the toggle button.  The
  154.      _C_o_m_m_u_n_i_c_a_t_i_o_n _M_e_t_h_o_d specifies how _c_o_s_m_o_c_r_e_a_t_e is to tell the browser to
  155.      load a new file.  Depending on the communication method specified, a
  156.      communication port number may be required. Consult your browser
  157.      documentation or your system administrator for the correct communication
  158.      port number.  The _c_o_n_t_r_o_l _p_a_r_a_m_s depend on the control method selected.
  159.      The following communication methods are available:
  160.  
  161.      NNNNoooonnnneeee           The browser cannot be remote controlled. Each time the
  162.                     current page is previewed, a new copy of the browser will
  163.                     be run.
  164.  
  165.      TTTTeeeexxxxtttt OOOOnnnnllllyyyy      The browser cannot be remote controlled and requires a TTY
  166.                     terminal shell.  The Lynx browser is a typical example of
  167.                     this type of browser. Each time the current page is
  168.                     previewed, a new window shell running the browser will be
  169.                     run.
  170.  
  171.      NNNNeeeettttssssccccaaaappppeeee       This method is used to control the Netscape Navigator
  172.                     version 2.0 and higher.  The method uses the -_r_e_m_o_t_e
  173.                     command line argument to control the browser and provides
  174.                     workarounds for bugs in remote control viewing with
  175.                     FRAMESETs.
  176.  
  177.      NNNNeeeettttssssccccaaaappppeeee 1111....1111   This method is used to control the Netscape Navigator
  178.                     version 1.1.  The method uses the -_r_e_m_o_t_e command line
  179.                     argument to control the browser.
  180.  
  181.      NNNNeeeettttssssccccaaaappppeeee 1111....0000   This method is used to control the Netscape Navigator
  182.                     version 1.0.  The method is identical to the NNNNOOOONNNNEEEE method
  183.                     since the 1.0 version of the Netscape Navigator did not
  184.                     support remote control.
  185.  
  186.      MMMMoooossssaaaaiiiicccc UUUUSSSSRRRR1111    This method is used to control older versions of the NCSA
  187.                     Mosaic browser.  The method issues the signal SSSSIIIIGGGGUUUUSSSSRRRR1111 to
  188.                     control the browser.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))                   CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee                    CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))
  203.  
  204.  
  205.  
  206.      MMMMoooossssaaaaiiiicccc CCCCCCCCIIII     This method is used to control current versions of the
  207.                     NCSA Mosaic browser.  The method uses the Common Client
  208.                     Interface protocol to control the browser.  This method
  209.                     requires one control parameter. The parameter is an
  210.                     integer between 1024 and 65535 and is used as the TCP/IP
  211.                     port number for communication between _c_o_s_m_o_c_r_e_a_t_e and the
  212.                     Web browser.
  213.  
  214.      MMMMoooossssaaaaiiiicccc SSSSDDDDIIII     This method is used to control the Spyglass version of the
  215.                     Mosaic browser.  The method uses the Software Development
  216.                     Interface protocol to control the browser.  This method
  217.                     requires one control parameter. The parameter is an
  218.                     integer between 1024 and 65535 and is used as the TCP/IP
  219.                     port number for communication between _c_o_s_m_o_c_r_e_a_t_e and the
  220.                     Web browser. NNNNOOOOTTTTEEEE::::  Certain versions of Spyglass' eMosaic
  221.                     browser are actually launched from a shell script called
  222.                     eMosaic. Due to a bug in that shell script the browser
  223.                     cannot be launched from _c_o_s_m_o_c_r_e_a_t_e unless the following
  224.                     line is added to the top of the script: ####!!!! ////bbbbiiiinnnn////sssshhhh.
  225.  
  226.      Browsers that cannot be found will be displayed greyed out in
  227.      _c_o_s_m_o_c_r_e_a_t_e.  The control methods tend to be browser specific. Check with
  228.      your browser vendor to determine which control method is applicable. At a
  229.      minimum the NNNNoooonnnneeee method will always work at the cost of cluttering up the
  230.      screen with multiple copies of the browser.
  231.  
  232.    CCCChhhhaaaannnnggggiiiinnnngggg SSSSoooouuuurrrrcccceeee EEEEddddiiiittttiiiinnnngggg PPPPrrrreeeeffffeeeerrrreeeennnncccceeeessss
  233.      The tab stops and colors used in the View/Edit Source window can be
  234.      changed by editing the _c_o_s_m_o_c_r_e_a_t_e-_p_r_e_f_e_r_e_n_c_e_s file (see CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn
  235.      FFFFiiiilllleeeessss above).  To create a preferences file select Save from the
  236.      Preferences dialog.  The tab stop preference has the name _s_o_u_r_c_e_T_a_b_S_t_o_p
  237.      and the color preferences have the name _s_o_u_r_c_e<_t_y_p_e>_C_o_l_o_r. Colors can be
  238.      specified as HTML color names (e.g. red, green, etc.) or as #RRGGBB
  239.      values.
  240.  
  241.    HHHHTTTTMMMMLLLL PPPPaaaarrrrsssseeeerrrr WWWWaaaarrrrnnnniiiinnnnggggssss
  242.      By default _c_o_s_m_o_c_r_e_a_t_e does not display warnings from the HTML parser.
  243.      There are two ways to configure _c_o_s_m_o_c_r_e_a_t_e to display parser warnings.
  244.      The first method is to turn on warnings using the program preferences
  245.      dialog. The second method is to specify ----wwwwaaaarrrrnnnn on the command-line.
  246.      Specifying ----wwwwaaaarrrrnnnn overrides any saved preference for warnings.  Specifying
  247.      the Xt resource ****sssshhhhoooowwwwWWWWaaaarrrrnnnniiiinnnnggggssss:::: TTTTrrrruuuueeee is equivalent to -warn.
  248.  
  249.    SSSSttttaaaarrrrttttiiiinnnngggg SSSSoooouuuurrrrcccceeee LLLLiiiinnnneeee
  250.      The ----ssssoooouuuurrrrcccceeeelllliiiinnnneeee option attempts to position the insertion point in the
  251.      WYSIWYG editing window on a line corresponding to the HTML source file
  252.      line number specified. The correspondence of the insertion point to the
  253.      HTML source line is approximate and can be off by a line under certain
  254.      circumstances.  Specificying the Xt resource ****ssssoooouuuurrrrcccceeeeLLLLiiiinnnneeee:::: ######## is
  255.      equivalent to -sourceline.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))                   CCCCoooossssmmmmooooCCCCrrrreeeeaaaatttteeee                    CCCCOOOOSSSSMMMMOOOOCCCCRRRREEEEAAAATTTTEEEE((((1111))))
  269.  
  270.  
  271.  
  272.    LLLLiiiinnnnkkkk GGGGeeeennnneeeerrrraaaattttiiiioooonnnn CCCCoooommmmmmmmaaaannnndddd TTTTiiiimmmmeeeeoooouuuutttt
  273.      By default, the command used to generate a link must complete within 30
  274.      seconds or the command will timeout. If 30 seconds is insufficient, the
  275.      timeout can be changed using the Xt resource ****ccccmmmmddddTTTTiiiimmmmeeeeoooouuuutttt:::: ######## where ######## is
  276.      the number of seconds for the timeout.
  277.  
  278. FFFFIIIILLLLEEEESSSS
  279.      /usr/sbin/CosmoCreate                    Program executable
  280.      /usr/sbin/cosmocreate                    Link to CosmoCreate
  281.      /usr/sbin/webmagic                       Link to CosmoCreate
  282.      /usr/lib/X11/app-defaults/CosmoCreate    Program resource file
  283.      $HOME/.spelling                          Personal spelling dictionaries
  284.      $HOME/.cosmocreate                       Program configuration file
  285.                                               directory
  286.      ./.cosmocreate                           Program configuration file
  287.                                               directory
  288.      .cosmocreate/cosmocreate-preferences     User preferences file
  289.      .cosmocreate/cosmocreate-layout          User layout preferences for
  290.                                               editing window, palettes,
  291.                                               toolbars, etc.
  292.      /usr/share/Cosmocreate/templates         HTML template directory
  293.      /var/tmp                                 Fallback location for checkpoint
  294.                                               files
  295.      *.bak                                    Backup file
  296.      *.sav                                    Checkpoint file
  297. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  298.      Cosmo Create online help and user's guide, netscape(1)
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.